Inside Macintosh: Programming With the Text Encoding Conversion Manager /

Chapter 4 - Unicode Converter Reference / Unicode Converter Structures and Other Types

/

UnicodeToTextRunInfo

Many of the Unicode Converter functions that perform conversions require a Unicode converter object containing information used for the conversion process. There are three types of Unicode converter objects used for different types of conversions. You use the UnicodeToTextRunInfo type, described here, for converting from Unicode to multiple encodings.

Because your application cannot directly create or modify the contents of the private Unicode converter object, the Unicode Converter provides functions to create and dispose of it. You can use any of three functions to create a Unicode converter object for converting from Unicode to multiple encodings. You can use CreateUnicodeToTextRunInfo (page 145), CreateUnicodeToTextRunInfoByEncoding (page 147), or CreateUnicodeToTextRunInfoByScriptCode (page 149).

You can then pass this object to the function ConvertFromUnicodeToTextRun (page 150) or ConvertFromUnicodeToScriptCodeRun (page 155) to identify the information used to perform the actual conversion. After you have finished using the object, you should release the memory allocated for it by calling the function DisposeUnicodeToTextRunInfo (page 159).

A Unicode converter object for this purpose is defined by the UnicodeToTextRunInfo data type.

typedef struct OpaqueUnicodeToTextRunInfo *UnicodeToTextRunInfo;

SEE ALSO

The Unicode converter object of type TextToUnicodeInfo (page 119) that you use for converting from non-Unicode text to Unicode text.

The Unicode converter object of type UnicodeToTextInfo (page 120) that you use for converting from Unicode text to non-Unicode text.